maintenance/userFunctions.inc

   1 <?php
   2
   3 /**
   4  * Support functions for dealing with user accounts at a database level
   5  *
   6  * @package MediaWiki
   7  * @subpackage Maintenance
   8  * @author Rob Church <robchur@gmail.com>
   9  */
  10
  11 /**
  12  * Count the number of edits the specified user has made
  13  *
  14  * @param integer $user User ID
  15  * @param bool $slave Whether or not a slave can be used
  16  * @return integer
  17  */
  18 function CountEdits( $user, $slave = true ) {
  19         $dbw =& wfGetDB( $slave ? DB_SLAVE: DB_MASTER );
  20         # Count current edits
  21         $res = $dbw->select( 'revision', 'COUNT(rev_id) AS count', array( 'rev_user' => $user ) );
  22         $row = $dbw->fetchObject( $res );
  23         $count = $row->count;
  24         # Count deleted edits
  25         $res = $dbw->select( 'archive', 'COUNT(*) AS count', array( 'ar_user' => $user ) );
  26         $row = $dbw->fetchObject( $res );
  27         $count += $row->count;
  28         # Done
  29         return( $count );
  30 }
  31
  32 /**
  33  * Count the number of images the specified user has uploaded
  34  *
  35  * @param integer $user User ID
  36  * @param bool $slave Whether or not a slave can be used
  37  * @return integer
  38  */
  39 function CountImages( $user, $slave = true ) {
  40         $dbw =& wfGetDB( $slave ? DB_SLAVE: DB_MASTER );
  41         # Count current images
  42         $res = $dbw->select( 'image', 'COUNT(rev_id) AS count', array( 'img_user' => $user ) );
  43         $row = $dbw->fetchObject( $res );
  44         $count = $row->count;
  45         # Count deleted edits
  46         $res = $dbw->select( 'oldimage', 'COUNT(*) AS count', array( 'oi_user' => $user ) );
  47         $row = $dbw->fetchObject( $res );
  48         $count += $row->count;
  49         # Done
  50         return( $count );
  51 }
  52
  53 /**
  54  * Retrieve all valid user IDs
  55  *
  56  * @return array
  57  */
  58 function GetUsers() {
  59         $dbr =& wfGetDB( DB_SLAVE );
  60         $res = $dbr->select( 'user', 'user_id' );
  61         $users = array();
  62         while( $row = $dbr->fetchObject( $res ) ) {
  63                 $users[] = $row->user_id;
  64         }
  65         return( $users );
  66 }
  67
  68 /**
  69  * Resolve a username to a user ID
  70  *
  71  * @param string $username Username
  72  * @return mixed
  73  */
  74 function GetUserID( $username ) {
  75         $dbr =& wfGetDB( DB_SLAVE );
  76         $res = $dbr->select( 'user', 'user_id', array( 'user_name' => '"' . $username . '"' ) );
  77         if( $res !== false ) {
  78                 $row = $dbr->fetchObject( $res );
  79                 return( $row->user_id );
  80         } else {
  81                 return( false );
  82         }
  83 }
  84
  85 /**
  86  * Delete one or more users
  87  *
  88  * @param mixed $users Single integer or array of integers corresponding to user IDs
  89  * @return bool
  90  */
  91 function DeleteUsers( $users ) {
  92         $dbw =& wfGetDB( DB_MASTER );
  93         $dbw->begin();
  94         foreach( $users as $user ) {
  95                 $dbw->delete( 'user', array( 'user_id' => $user ) );
  96         }
  97         $dbw->commit();
  98         return( true );
  99 }
 100
 101 /**
 102  * Add a user to the named group(s)
 103  *
 104  * @param integer $user User ID
 105  * @param mixed $groups Single string or array of strings corresponding to group names
 106  * @return bool
 107  */
 108 function SetUserGroups( $user, $groups ) {
 109         $dbw =& wfGetDB( DB_MASTER );
 110         foreach( $groups as $group ) {
 111                 $row = array( 'ug_user' => $user, 'ug_group' => $group );
 112                 if( !$dbw->insert( 'user_groups', $row, 'SetUserGroups' ) ) {
 113                         return( false );
 114                 }
 115         }
 116         return( true );
 117 }
 118
 119 ?>